跳到主要内容

错误码与枚举说明

枚举定义​

产品类型 (productType)​

  • SEVEN_DAY_APR - 7天年化利率产品
  • THIRTY_DAY_APR - 30天年化利率产品
  • DEMAND - 活期借贷产品
  • VIP - VIP借贷产品

订单类型 (type)​

  • ORDINARY - 普通订单
  • VIP - VIP订单
  • NOVICE - 新手订单

订单状态 (status)​

  • RUNNING - 运行中
  • REPAYING - 还款中
  • FORCE_LIQUIDATING - 强制平仓中
  • OVERDUE - 逾期
  • REPAID - 已还款
  • RENEWED - 已续借
  • FORCE_LIQUIDATED - 已强制平仓
  • COMPLETE - 已完成

还款类型 (repaymentType)​

  • ORDINARY_REPAYMENT - 普通还款
  • PLEDGE_REPAYMENT - 质押物还款

调整质押物类型 (adjustPledgeType)​

  • ADD - 增加质押物
  • REMOVE - 减少质押物

调整触发类型 (adjustPledgeRateType)​

  • MANUAL - 手动调整
  • AUTO - 自动调整

借贷类型 (loanType)​

  • LOAN - 负债
  • PLEDGE - 质押

错误码说明​

HTTP 状态码​

状态码说明
0成功
1业务异常

业务错误码 (FinanceLoanOrderResponse.Status)​

通用错误 (FINANCE_LOAN_ORDER_001-010)​

错误码说明触发条件
FINANCE_LOAN_ORDER_002存在逾期订单用户有未处理的逾期订单，必须先处理
FINANCE_LOAN_ORDER_003产品/服务不可用产品下架、货币下线、交易禁用或价格异常
FINANCE_LOAN_ORDER_004VIP配置无效VIP借贷配置为空或不可用
FINANCE_LOAN_ORDER_005价格波动过大价格波动超过5%阈值
FINANCE_LOAN_ORDER_007不支持续借货币下线、产品不可用或交易禁用
FINANCE_LOAN_ORDER_008质押率过高当前质押率超过预警阈值
FINANCE_LOAN_ORDER_009余额不足账户余额少于所需利息金额
FINANCE_LOAN_ORDER_010订单已续借该借款订单已经续借过

参数验证错误 (FINANCE_LOAN_ORDER_011-020)​

错误码说明触发条件
FINANCE_LOAN_ORDER_011不允许调整质押货币下线或交易禁用
FINANCE_LOAN_ORDER_014相同货币错误借款币种和质押币种不能相同
FINANCE_LOAN_ORDER_015借款金额过小借款金额低于最小要求金额
FINANCE_LOAN_ORDER_016借款金额超限借款金额超过最大可借金额
FINANCE_LOAN_ORDER_017质押金额超限质押金额超过最大允许质押金额
FINANCE_LOAN_ORDER_018质押率超预警用户输入的质押率超过预警比率

业务逻辑错误 (FINANCE_LOAN_ORDER_021-030)​

错误码说明触发条件
FINANCE_LOAN_ORDER_021余额未找到指定货币的用户余额未找到
FINANCE_LOAN_ORDER_025续借时间未到续借时间尚未到达
FINANCE_LOAN_ORDER_026还款金额超限还款金额超过总债务（本金+利息+罚息）
FINANCE_LOAN_ORDER_029余额API错误获取账户余额时发生错误
FINANCE_LOAN_ORDER_030赎回质押超限赎回质押金额超过最大可赎回金额

产品类型错误 (FINANCE_LOAN_ORDER_031-040)​

错误码说明触发条件
FINANCE_LOAN_ORDER_031产品类型不可用指定产品类型不可用
FINANCE_LOAN_ORDER_032续借产品类型无效续借产品类型无效
FINANCE_LOAN_ORDER_033VIP最小金额不足VIP借款金额低于最小要求
FINANCE_LOAN_ORDER_034精度验证失败金额精度超过货币允许最大精度
FINANCE_LOAN_ORDER_035新手活动不可用新手借贷活动不可用或已禁用
FINANCE_LOAN_ORDER_036非新手用户用户不符合新手借贷条件
FINANCE_LOAN_ORDER_037需要KYC验证用户未完成所需的KYC验证（2级+）
FINANCE_LOAN_ORDER_038新手+优惠券冲突新手借贷活动不能使用优惠券
FINANCE_LOAN_ORDER_039VIP+优惠券冲突VIP借贷不能使用优惠券
FINANCE_LOAN_ORDER_040优惠券不匹配借贷信息与优惠券不匹配

特殊操作错误 (FINANCE_LOAN_ORDER_041+)​

错误码说明触发条件
FINANCE_LOAN_ORDER_041优惠券不可用折扣优惠券已禁用或不可用
FINANCE_LOAN_ORDER_042还款余额不足一键还款时余额不足
FINANCE_LOAN_ORDER_043无运行中订单一键还款时未找到运行中订单
FINANCE_LOAN_ORDER_044还款请求无效单项一键还款请求无效

更新日志​

v1.0.0 (2025-09-23)​

  • 初始版本发布
  • 支持基础借款、还款功能
  • 支持质押物调整功能
  • 支持续借功能
  • 支持一键还款功能
  • 支持自动补仓设置
  • 支持历史查询功能